M

ElementTransformUtils.CopyElements

Description:
Copies a set of elements from source document to destination document.

Remarks:

Copies are placed at their respective original locations or locations specified by the optional transformation.

This method can be used for copying non-view specific elements only. For copying view-specific elements, use the view-specific form of the CopyElements method.

The destination document can be the same as the source document.

This method performs rehosting of elements where applicable.

Overloads (3):

CopyElements(Document,ICollection[ElementId],Document,Transform,CopyPasteOptions)

CopyElements(Document,ICollection[ElementId],XYZ)

CopyElements(View,ICollection[ElementId],View,Transform,CopyPasteOptions)

public static ICollection<ElementId> CopyElements(
	Document sourceDocument,
	ICollection<ElementId> elementsToCopy,
	Document destinationDocument,
	Transform transform,
	CopyPasteOptions options
)

Public Shared Function CopyElements ( _
	sourceDocument As Document, _
	elementsToCopy As ICollection(Of ElementId), _
	destinationDocument As Document, _
	transform As Transform, _
	options As CopyPasteOptions _
) As ICollection(Of ElementId)

public:
static ICollection<ElementId^>^ CopyElements(
	Document^ sourceDocument, 
	ICollection<ElementId^>^ elementsToCopy, 
	Document^ destinationDocument, 
	Transform^ transform, 
	CopyPasteOptions^ options
)

Autodesk.Revit.DB.Document

sourceDocument

The document that contains the elements to copy.
ICollection<ElementId>

elementsToCopy

The set of elements to copy.
Autodesk.Revit.DB.Document

destinationDocument

The destination document to paste the elements into.
Autodesk.Revit.DB.Transform

transform

The transform for the new elements. Can be nulla null reference (Nothing in Visual Basic) if no transform is required.
Autodesk.Revit.DB.CopyPasteOptions

options

Optional settings. Can be nulla null reference (Nothing in Visual Basic) if default settings should be used.

Return Value ICollection<ElementId> The ids of the newly created copied elements.

Autodesk.Revit.Exceptions.ArgumentException

The given element id set is empty. -or- One or more elements in elementsToCopy do not exist in the document. -or- Some of the elements cannot be copied, because they are view-specific.
Autodesk.Revit.Exceptions.ArgumentNullException

A non-optional argument was NULL
Autodesk.Revit.Exceptions.InvalidOperationException

The elements cannot be copied.
Autodesk.Revit.Exceptions.OperationCanceledException

User cancelled the operation.